home *** CD-ROM | disk | FTP | other *** search
/ A.C.E. 3 / ACE CD 3.iso / files / games / 1-l / f1gpassd.dms / in.adf / SplitTime / SplitTime.doc < prev    next >
Encoding:
Text File  |  1995-12-07  |  13.6 KB  |  343 lines
  1.  
  2.                            SplitTime v1.3
  3.  
  4.                                  by
  5.  
  6.                               Rene Smit
  7.  
  8.                              7 Dec 1995
  9.  
  10.  
  11. This document describes SplitTime, a public domain utility which gives you
  12. three split times during your laps in World Circuit/Formula One Grandprix.
  13.  
  14. If you have any comments, buglists or suggestions feel free to mail me:
  15.  
  16. E-Mail:
  17.  
  18.         R.Smit@twi.tudelft.nl
  19.  
  20. WWW:
  21.         http://dutian.twi.tudelft/~smit/sdihome.html
  22.  
  23. Snail Mail:
  24.  
  25.         Rene Smit
  26.         Wenckebachstraat 42
  27.         2522 CL  The Hague
  28.         The Netherlands
  29.  
  30.  
  31.  
  32. Disclaimer
  33. ----------
  34. I hereby state that I am not responsible for any damage or loss of
  35. data, whether or not caused by using either SplitTime or PrintSplits.
  36.  
  37.  
  38.  
  39. Distribution
  40. ------------
  41. You may copy SplitTime to everyone as long as you copy the original
  42. lha file containing the following files:
  43.  
  44. - SplitTime        (c) 1995 Rene Smit
  45. - SplitTime.doc
  46. - PrintSplits        (c) 1995 Rene Smit
  47. - libs/f1gp.library    (c) 1995 Oliver Roberts
  48.  
  49. The f1gp.library was made by Oliver Roberts. The version of the library
  50. included here is 35.1.
  51.  
  52.  
  53.  
  54. What's new?
  55. -----------
  56. Added in v1.3:
  57. - Autosave option.
  58. - Fixed a bug that caused problems with KS1.3 users.
  59. - Safer way of displaying split times.
  60. - Added split times in race.
  61. - Changed the virtual lap time row to a virtual times column.
  62. - Added a light on the dashboard that indicates if a split is improved.
  63.  
  64.  
  65.  
  66. What is SplitTime?
  67. ------------------
  68. SplitTime is a utility that displays split times at every quarter of a
  69. track while you drive F1GP (so you need that game to use it). Not only
  70. the splittimes are displayed, but also the best splittimes before they
  71. show up (like on TV). Note that I use 3 split times on every track and
  72. that they are exactly at 25%, 50% and 75%, while on TV they now use
  73. only 2 split times (intermediates) at specific points on the track.
  74.  
  75.  
  76. Why do I need it?
  77. -----------------
  78. This utility let's you know how well you're on your way while driving a
  79. lap, so you don't have to drive the whole lap before knowing if you drove
  80. well. Normally, you have your own physical markers and locations at which
  81. you look at the timer to know how fast you're on your way, but now you can
  82. forget those and use these very accurate splittimes instead. If you finish
  83. a lap and forget the split times you drove, don't worry, they can be
  84. viewed in the SplitTime window, as well as some other info.
  85.  
  86.  
  87. Is this all?
  88. ------------
  89. No, this is not all. Besides showing (best) splittimes it also keeps track
  90. of the best split differences, calculated by looking at the time between
  91. two consecutive splittimes. The four best differences are always remembered
  92. and from these, virtual split times are calculated, which means that you are
  93. able to see what time you could have driven if you had done a perfect lap.
  94.  
  95. All times can be saved to disk so nothing will be lost. This means that
  96. once you have improved a splittime you will see it on your display from
  97. then on every time you are gonna play f1gp again. The car number is saved
  98. with each split difference, so if more people are driving with the same
  99. datafile and they use different car numbers, you can see to whom each split
  100. difference belongs. Also, the lap in which it was driven is stored so you
  101. can see in which lap you drive a certain part best and determine how you
  102. can best warm up your tyres. Note that f1gp does not reset the lap number
  103. to 1 if you drive into your pit position in qualify, instead of pressing
  104. 'q'.
  105.  
  106.  
  107. What do I require?
  108. ------------------
  109. - Any Amiga. People using kickstart 1.x will miss the commandline options,
  110.   and will have default options.
  111. - F1GP by Microprose, any version (European F1GP, World Circuit or the
  112.   A600 WWW version).
  113. - Oliver Roberts' f1gp.library, necessary for SplitTime to work.
  114.   f1gp.library is included with SplitTime in the directory 'libs'. You need
  115.   to copy the library to your libs: directory. If you already have one from
  116.   the latest f1gp-ed, you don't need to do that as the f1gp.library supplied
  117.   with f1gp-ed is always the same or newer as the one included here.
  118.  
  119.  
  120. How do I start it?
  121. ------------------
  122. Start this program after f1gp is run and it shows 'please wait', from cli
  123. or workbench (although SplitTime doesn't support tooltypes yet).
  124. It is also possible to run it without f1gp, in which case only the times
  125. can be viewed, but it's better to use PrintSplits for that (see below).
  126.  
  127. For the options you need to start SplitTime from the cli with the following
  128. synopsis:
  129.  
  130.   SplitTime NAME,DELAY/N,AU=AUTOUPDATE/S,AS=AUTOSAVE/S,NORACE/S,NOLIGHT/S,
  131.             QUIT/S,LEFT/N,TOP/N,QUIET/S
  132.  
  133. This is what each option does (KS 2.0+ only; to KS 1.x users it will
  134. appear as none of these options are specified, except for the QUIT option):
  135.  
  136. NAME
  137.     Specify filename for the datafile. If not specified, the filename
  138.     s:SplitTime.dat will be used. If the file does not exist, it will
  139.     be created when the data is saved from within the program.
  140.     Old versions will be converted.
  141.  
  142. DELAY/N
  143.     Display suspend delay, the time that the (split)time is shown on
  144.     the dashboard before it's replace by the clock again. Default 5
  145.     seconds (the game originally uses 10 secs for the laptime). It may
  146.     not be negative or more than 10 seconds.
  147.  
  148. AUTOUPDATE/S
  149.     If specified, SplitTime wil automatically update the window contents
  150.     if an improvement has been made while you were driving.
  151.  
  152. AUTOSAVE/S
  153.     If specified, SplitTime wil automatically save the split times.
  154.     This option will enable the AUTOUPDATE option, and will save the
  155.     times at the moment there would normally be an automatic update.
  156.  
  157. NORACE/S
  158.     Will disable split times in the race.
  159.  
  160. NORACE/S
  161.     Will disable the little light that indicates a split improvement.
  162.  
  163. QUIT/S
  164.     If specified, SplitTime will automatically quit if f1gp quits. The
  165.     data will be saved before it does so. Kickstart 1.x users will have
  166.     this enabled.
  167.  
  168. LEFT/N
  169.     Specify left offset for window.
  170.  
  171. TOP/N
  172.     Specify top offset for window.
  173.  
  174. QUIET/S
  175.     Tell SplitTime to shut up.
  176.  
  177.  
  178.  
  179. How do I use it?
  180. ----------------
  181. When f1gp is found it opens a window. The window will be full of '-:--.---'
  182. lines when you start it, but after driving a lap they will already be filled
  183. with times. At the top is a line that tells you the name of the currently
  184. selected track ('not selected' at first). The bottom line will give you some
  185. info about what's going on. In between there is the real data. There are
  186. seven columns: Spl, Car, Lap, BestDiff, VirtTime, BestTime and LastTime.
  187. The 'Spl' column contains the split number for each row. There are four
  188. rows (1/4 ... 4/4).
  189. The 'Car' and 'Lap' columns contain the car number and lap number in which
  190. each best split difference is done. The lap is always 2 or higher in non-race
  191. sessions since the first lap is a warm-up lap. For the race the lap will be
  192. 1 or higher.
  193. The 'BestDiff' column shows you the best split difference, i.e. it shows how
  194. much time it took to drive the corresponding quarter of the track, and this
  195. only gets updated when it's improved.
  196. The 'VirtTime' column is derived from the 'BestDiff' column and shows the
  197. virtual split times you could have driven if the best split differences had
  198. been done in one go. The 4th one is your virtual laptime (this one was shown
  199. in previous versions).
  200. The 'BestTime' column contains the best split time at each quarter of the
  201. track. The one at the bottom will match your best laptime, and for this one
  202. additional info is being stored (although not shown) like the setup, traction
  203. control on or off, and more. This info can be viewed with the external
  204. split data viewer PrintSplits (use the VERBOSE option).
  205. The column most to the right, 'LastTime', contains the split times that have
  206. been driven the last time. Once you cross the first split with your car they
  207. will be cleared again.
  208.  
  209. As you drive laps and switch back to the workbench to look at the SplitTime
  210. window, you can click the mouse button in the window or press <return>
  211. while it is selected to get an update of your times. If the AUTOUPDATE option
  212. was specified, the times will be updated automatically and the workbench
  213. screen will be brought to front to let you watch them. You'll see that the
  214. improved times will be highlighted in order to help you notice where you
  215. drove better than the previous time.
  216. Note that the autoupdate updates the times when the system is enabled, i.e
  217. after you press <esc>, so only times that have been updated since the last
  218. time you left cockpit will be highlighted. If the AUTOSAVE option was
  219. specified the times will be saved as well (look out, you cannot revert
  220. the data this way).
  221.  
  222. Besides this, you can be kept up to date of your performance while you're
  223. driving too. A little light on the right (above the 'player' light), will
  224. have a certain colour after each split. If you improve a split time but
  225. not a split diff, it will be grey. If you improve a split diff but not a
  226. split time it will be dark yellow. If you improve both the split time and
  227. split diff it will be light yellow. Else it will be off (black). If you
  228. find this light distracting you can turn it off with the NOLIGHT option.
  229.  
  230. The window doesn't have any buttons, but every command can be given by
  231. pressing a key while the window is activated. For normal use you don't even
  232. have to touch a key, as clicking the mousebutton on the window will select
  233. the track that you just drove on (if you did so) and will update all the
  234. times. The times are saved automatically when f1gp quits and the QUIT option
  235. has been specified when you started SplitTime. If you didn't, then the times
  236. can only be saved with the 's' key or have them saved automatically when
  237. you quit by pressing the <escape> key. There are no filerequesters, but the
  238. data will be saved to s:SplitTime.dat or to the file that was specified
  239. on the commandline. The same goes for the 'load' command ('l' key).
  240. If you want to quit but don't want to save the data you can use the close
  241. button of the window, or use ctrl-c in the shell you started SplitTime from.
  242.  
  243. Here is the list of keystrokes:
  244.  
  245. 1..9a..g    select a track:
  246.         1=Phoenix, 2=Interlagos, ..., g=Adelaide.
  247. crsr up        select first track (Phoenix).
  248. crsr down    select last track (Adelaide).
  249. crsr left    select previous track.
  250. crsr right    select next track.
  251. 's'        save all data to disk.
  252. 'l'        load all data (no questions asked!).
  253. <return>    update display (or click the mousebutton in the window).
  254. <del>        clear all times of currently selected track (you will be
  255.         asked for confirmation, press 'y' to confirm).
  256. F1-F4        will erase the corresponding split difference.
  257. F6-F9        same as F1-F4, but will erase a split time.
  258. <esc>        save (if something has changed) all data and quit.
  259.  
  260.  
  261. Kickstart 1.x users won't be able to use the cursor keys or the function
  262. keys due to a system bug.
  263.  
  264.  
  265. What about my old datafile?
  266. ---------------------------
  267. If you have used SplitTime v1.0 before this one you have probably a datafile
  268. for it. SplitTime v1.3 can load the old datafile, but it won't have the new
  269. data I added (setup and stuff). If you save it again, it will be converted
  270. to a new datafile.
  271. The datafile format hasn't changed anymore since v1.1.
  272.  
  273.  
  274. How do I print the data?
  275. ------------------------
  276. I have made an external print program named PrintSplits which will print
  277. your data to standard output (use the redirection option or the copy to
  278. clipboard option of the shell to get it into a file).
  279.  
  280. Usage:
  281.  
  282. PrintSplits NAME/K,TRACK/N,VERBOSE/S,LIST/S
  283.  
  284. NAME/K
  285.     Name of the datafile.
  286.     If not specified, "s:SplitTime.dat" will be tried.
  287.  
  288. TRACK/N
  289.     Track number of which you want to print the data.
  290.     If not specified, data of all tracks will be printed.
  291.  
  292. VERBOSE/S
  293.     If specified, some extra information will be printed like the
  294.     setup and horsepower used for the best lap (4th best split time).
  295.     It will also print if traction control was on or off.
  296.  
  297. LIST/S
  298.     If specified, only a list of all the tracks with each track
  299.     number will be printed, so you can see what number to specify
  300.     for a track.
  301.  
  302.  
  303.  
  304. Some notes about using SplitTime
  305. --------------------------------
  306. Sometimes the split time is clocked in the middle of a corner. This can
  307. be annoying since the time then depends on the moment you brake for the
  308. corner. For example, if you brake too late into the corner, the split time
  309. will be good, but the next split time will probably be a bad one since
  310. you exit the badly taken corner with lower speed. Such split times mess
  311. up the virtual record a bit in a way that it tells you that you can drive
  312. a certain time, but that it's not the case in reality.
  313. Of course it's possible for me to change the locations at which the splits
  314. are clocked, but I wanted to keep them this way because then they would
  315. be the same as on the pc. I may have changed it though in a next version.
  316. Whenever you mess up a split time or difference like this, you are able
  317. to clear each individual difference with keys F1 to F4, and each split time
  318. with keys F5 to F9 (not with kickstart 1.x). Or clear everything in one go
  319. with the <del> key.
  320.  
  321. When driving with different setups, frame frates or other configurations,
  322. the virtual times can be affected also. It is advised to use a different
  323. datafile for each configuration so you can always compare the virtual
  324. record or individual split times/differences.
  325.  
  326. It is better _not_ to quit and/or (re)start SplitTime in the middle of a
  327. session. Although nothing serious can go wrong it is possible that the
  328. best laptime the game keeps track of will be erased by SplitTime, or
  329. the other way round.
  330.  
  331.  
  332.  
  333. People I want to thank
  334. ----------------------
  335. Thanks go to:
  336. - Grant Reeve for helping me and beta-testing.
  337. - Oliver Roberts for beta-testing and his support.
  338. - Dave Wright for testing with kickstart 1.3.
  339. - Edo Nijmeijer, Maarten van Schouwen and Patrick Giesbergen for beta-testing.
  340. - Trevor Kellaway who made SPLITTIM on the pc which gave me the idea to
  341.   code it for the Amiga.
  342. - All the people who gave me feedback!
  343.